home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / uniterm.zoo / readme_v.20c < prev    next >
Encoding:
Text File  |  1990-04-06  |  11.0 KB  |  367 lines
  1. ReadMe for UniTerm V2.0c 016 <-| 
  2. ----------------------------   |
  3. 5.5.88                         |This number is displayed on the 
  4.                                 'About UniTerm...' dialog box and 
  5.                                 indicates the "Edit Number"
  6.  
  7. Changes 2.0b to 2.0c
  8. --------------------
  9.  
  10. General: A lot of the oldest code in UniTerm has been redone. Some things
  11.          should be even faster now.
  12.       
  13.          The 20ATO20C.TOS program will convert 2.0a/2.0b setup files
  14.          to 2.0c format, remote commands will be disabled, clipboard
  15.          size set to 2kB and NRC to ASCII (turned off).
  16.  
  17.          The delay time parameter now additionaly affects:
  18.  
  19.              start/end of transfer strings in ASCII file upload 
  20.              the dialer
  21.              macro processor send command
  22.              single-line editor.
  23.  
  24.          Keys moved: View History buffer (NEW!): <Alternate><V>
  25.             
  26.                      History Control:            <Alternate><S>
  27.  
  28.          Mouse cursor control now uses a double click with the
  29.          left button.
  30.  
  31.          UniTerm will no longer let you exit from the `Help' menu
  32.          if you still have desk accessory windows open. The deeper
  33.          reason for this is a AES deficiency.
  34.  
  35. Terminal Emulation:
  36.                      
  37.          NRC character sets implemented, they will naturally be
  38.          slower than the straight ASCII mode (the Dutch and 
  39.          Portugese sets are not completly implemented).
  40.  
  41.          I'm too lazy to list the corresponding escape sequences,
  42.          will be in the manual.
  43.  
  44.          NRC mode can also be set in the 'Terminal 2' dialog,
  45.          selecting [ASCII] just turns NRC mode off, selecting
  46.          one off the NRC sets, map the set into G0 and G0 into GL.
  47.  
  48.  
  49. *********************************
  50. *Macro processor: COMPLETLY NEW!*
  51. *********************************
  52.  
  53. The two modi (function key - macro file) are now more different, the % 
  54. command introducer is now only needed (and allowed!) on the function keys.
  55.  
  56. No more absolute line numbers (labels instead), additional integer and
  57. string variables.
  58.  
  59. No more boolean constants, use 0 and 1 intstead (for FALSE / TRUE)
  60.  
  61. Commands are no longer case sensitive.
  62.  
  63. Common features:
  64. ----------------
  65.  
  66.    Built-in functions:
  67.    -------------------
  68.  
  69.          add(int1,int2)      returns sum of int1 and int2.
  70.  
  71.          and(int1,int2)      returns logical 'and' of int1 and int2.
  72.  
  73.          assert()            asserts DTR.
  74.  
  75.          break(len,drop-dtr) send a break for len mS, drop DTR if
  76.                              if drop-dtr is true (<>0).
  77.  
  78.          concat(str1,str2)   concatenate str1 and str2 and return
  79.                              the result in $TEMP.
  80.  
  81.          copy(nr,str)        copy str into string variable nr (1 to 10).
  82.  
  83.          compare(str1,str2)  compare str1 to str2, return true if equal.
  84.  
  85.          drop()              drop DTR.
  86.  
  87.          dial(nr)            dial number nr (1 to 10), returns true if
  88.                              sucessful
  89.  
  90.          echo(str)           echo str to the screen.
  91.  
  92.          fileselector(path,filename,prompt)
  93.                              show a fileselector with path, filename and
  94.                              a prompt, returns true if [OK] is selected,
  95.                              $PATH and $FILENAME hold the values the user
  96.                              entered.
  97.          
  98.          get(instr,time)     wait for string instr, timeout after time
  99.                              seconds, returns true if sucessful.
  100.  
  101.          hangup()            hangup the modem.
  102.  
  103.          history(mode)       turn history saving on/off (1/0 for mode)
  104.  
  105.          inline(mode)        reads a line from the keyboard (until <Return>
  106.                              is pressed or a maximum of 80 characters are
  107.                              read (^C aborts)), if mode is true the characters
  108.                              are echoed, the line is returned in $TEMP.
  109.  
  110.          input(prompt)       prompt for a line of input, result is in $TEMP,
  111.                              returns true if [OK] is selected.
  112.  
  113.          kermit(mode,8-bit-mode,filespec)
  114.                              start Kermit filetransfer with:
  115.                              mode (string):   'SEND', 'REC' or 'GET'
  116.                              8-bit-mode: 1=true,0=false
  117.                              filespec: string with wildcards.
  118.  
  119.          loadsetup(name)     load a setup file. 
  120.  
  121.          loadtel(name)       load a dialer setup file
  122.  
  123.          message(str)        display str on the statusline, '' restores
  124.                              the normal statusline.
  125.  
  126.          macro(name)         execute macro file, returns value of exit
  127.                              function or:
  128.                                 -3 : syntax error (line in $TEMP)
  129.                                 -2 : not enough stack (macro files nested
  130.                                      more than one level)  
  131.                                 -1 : macro buffer full (max. 4096 bytes).
  132.        
  133.          or(int1,int2)       return logical 'or' of int1 and int2.
  134.         
  135.          path(str)           set GEMDOS path to str.
  136.  
  137.          popup(entry,command,name)
  138.                              redefine a popup menu entry
  139.  
  140.          run(name,commandline)
  141.                              run a program, returns the return code
  142.                              (negativ numbers display an alert box)
  143.  
  144.          reassign(alt-key,command)
  145.                              reassign the function of a 'Alt' key.
  146.  
  147.          suspend()           displays 'Press any key...' and waits
  148.                              for a keypress.
  149.  
  150.          send(str)           sends str.
  151.  
  152.          set(nr,int)         sets integer variable nr (1 to 10) to int.
  153.  
  154.          wait(int)           wait for int mS * 100
  155.  
  156.          unicommand(nr)      execute a UniTerm internal command.
  157.  
  158.          xmodem(mode,file)   start xmodem with:
  159.                              mode: 'SEND' or 'REC'
  160.                           
  161.          ymodem(mode,filespec) 
  162.                              start ymodem with:
  163.                              mode: 'SEND' or 'REC'  
  164.  
  165.                                               
  166.    Prefix operators (work only before arguments):
  167.    ----------------
  168.  
  169.       -  negate integer value
  170.       
  171.       !  logical not
  172.  
  173.       "  return integer as string
  174.  
  175.       .  return string as integer
  176.  
  177.    (. and " don't know about negative integers!)
  178.  
  179.    
  180.    String constants
  181.    ----------------
  182.  
  183.    Enclosed in single quotes, escape character '\', every character
  184.    after '\' equals itsself except:
  185.  
  186.       r    : \r is carrige return (ASCII 13)
  187.       n    : \n is newline (ASCII 10)
  188.       0xx  : \0xx is the octal ASCII value 0xx
  189.  
  190.    Predefined string variables:
  191.    ----------------------------
  192.  
  193.    $T ($TEMP) : used for return values of some built-in functions
  194.   
  195.    $F ($FILENAME) : see fileselector command
  196.    $P ($PATH)     :           "
  197.  
  198.    $C ($CURRENT) : current GEMDOS path
  199.  
  200.    $V ($VAR) : contains the address of UniTerm's parameter block
  201.  
  202.    String variables:
  203.    -----------------
  204.  
  205.    $1 to $10   max. 80 characters
  206.  
  207.    Integer variables:
  208.    ------------------
  209.  
  210.    @1 to @10  signed 16 bit value
  211.  
  212.  
  213. Additional features in macro file mode:
  214. ---------------------------------------
  215.  
  216.    Labels:
  217.    -------
  218.  
  219.    :1 to :20  (must be first and only word on a line!)
  220.  
  221.    Comments:
  222.    ---------
  223.  
  224.    A line starting with # is ignored on input.
  225.  
  226.    Additional statements
  227.    ---------------------
  228.  
  229.       if(int)     execute the rest of the line if int is <> 0
  230.  
  231.       jump(nr)    goto label number nr
  232.  
  233.       exit(int)   stop processing and return with value int
  234.  
  235.       call(nr)    execute subroutine at label nr (subroutines can't be 
  236.                   nested!)
  237.  
  238.       return()    return from subroutine
  239.  
  240.  
  241. *****************************************
  242. * History buffer viewing                *
  243. *****************************************
  244.  
  245. Needs at least 25kB of reserved system memory.
  246. Start with <Alternate><V>.
  247.  
  248. <ClrHome>                Display top of buffer
  249.  
  250. <Insert>                 Display bottom of buffer
  251.  
  252. <UpArrow>,<DnArrow>      Scroll line up/down
  253.  
  254. <RightArrow>,<LeftArrow> Page up/down
  255.  
  256. The mouse clipboard functions work the same as in normal mode.
  257.  
  258. ////////////////////////
  259. Incremental change list:
  260. ////////////////////////
  261.  
  262. V2.0c 002
  263. ---------
  264.  
  265. The default history buffer view mode now displays CR and LF as spaces,
  266. this makes cliping stuff from the buffer much more useful, the old mode
  267. can still be used with the command
  268.       
  269.         ViewHistEOL = 63
  270.  
  271. V2.0c 003
  272. ---------
  273.  
  274. Fixed a small bug in the mouse code that caused spurious 'Alt' keycodes
  275. to be generated.
  276.  
  277. Put the 'GDOS not loaded' message back in, this uses the (possibly invalid)
  278. rule that 'graf_handle' will not return 1 as the workstation handle.
  279. (As we all know the ST crashes if you try to open a workstation without
  280. having GDOS loaded....).
  281.  
  282. To avoid unnecessary contortions in initializing the data structures in
  283. the view buffer mode, it now just rings the bell and returns immediatly
  284. if you try to view an empty buffer, the same happens if you try to use
  285. while in tek mode.
  286.   
  287. V2.0c 004
  288. ---------
  289.  
  290. Fixed a bug in the new Kermit checksum code, the two character checksum
  291. wasn't masked properly.
  292.  
  293. V2.0c 005
  294. ---------
  295.  
  296. Saved a few bytes (11 to be exact).
  297.  
  298. V2.0c 006
  299. ---------
  300.  
  301. Fixed a really old bug in the routine that gets filenames out of dialogs,
  302. it sometimes inserted the '.' in the wrong place.
  303.  
  304. V2.0c 007
  305. ---------
  306.  
  307. Improved the actual time processing of a ESC character takes (it now takes
  308. 0.17 mS). 
  309.  
  310. V2.0c 008
  311. ---------
  312.  
  313. Fixed underline cursor. Fixed a bug in the line breaking code for viewing
  314. the history buffer. Moved the 'Help' dialog up a bit, so that it hopefully
  315. doesn't get truncated anymore on a color screen.
  316.  
  317. V2.0c 009
  318. ---------
  319.  
  320. Fixed a VERY nasty bug in the delete_in_line code.
  321.  
  322. V2.0c 010
  323. ---------
  324.  
  325. -Left and right mouse buttons work normally now for desk accessories
  326.  and programs that are run from UniTerm. 
  327. -UniTerm now remebers the last text terminal type selected (it always 
  328.  did this, it just didn't set it when switching by hand). 
  329. -Fixed XModem checksum bug (just a typo: addi instead of andi), it 
  330.  seems as if nobody ever uses this (and I missed it testing)........ 
  331. -Fixed autoprint messing up the screen.
  332.  
  333. V2.0c 011
  334. ---------
  335.  
  336. Just cleaned a few things up.
  337.  
  338. V2.0c 012
  339. ---------
  340.  
  341. Fixed minature bug, the device identifcation response in VT200 mode
  342. should be:
  343.    
  344.     ESC [?62;1;2;6;8;9c
  345.  
  346. (instead of ESC [?62;1;2;6;8;0c)
  347.  
  348. V2.0c 014
  349. ---------
  350.  
  351. Due to the pleas of Marion Hakanson, I put the %if() control statement
  352. in to the routine that processes function keys, my luck that I don't have
  353. to show the code to anybody........ 
  354.  
  355. V2.0c 015
  356. ---------
  357.  
  358. Fixed some problems that were due to UniTerm not cleaning up properly
  359. after fatal errors early in the initialization.
  360.  
  361. V2.0c 016
  362. ---------
  363.  
  364. Tiny cleanup.....
  365.  
  366. **************************************************************************
  367.